home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 076-100 / scopedisk97 / passthebucks / demo.doc < prev    next >
Text File  |  1995-03-19  |  22KB  |  496 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                            Pass-the-Bucks
  7.  
  8.                      a Personal-Accounts Program
  9.                              written by
  10.  
  11.                           Bob Dufford, S.J.
  12.  
  13.  
  14.  
  15. Overview
  16.  
  17.     Pass-the-Bucks is a program that helps you keep track of where money
  18. comes from and where it goes.  It can help you monitor budgets, reconcile
  19. bank and credit card statements, and watch the growth (or, ouch!, decline)
  20. of your financial net worth.
  21.  
  22.     More specifically, with Pass-the-Bucks you can-- 
  23.  
  24.     1) create and describe individual accounts;
  25.     2) enter transactions and process them against the accounts;
  26.     3) sort the transactions chronologically; 
  27.     4) display the transactions as a complete chronological journal;
  28.     5) display the accounts' data with balances shown as month-to-date,
  29.       quarter-to-date or year-to-date sums;
  30.     6) display the accounts with percentages comparing actual balances
  31.       with budget amounts for expense and income accounts;
  32.     7) display (as a ledger) selected transactions that affect a
  33.       particular account (including running totals);
  34.     8) send any of these displays to your printer or to a RAM file for 
  35.       inclusion in a word-processing document;
  36.     9) modify or delete any transaction;
  37.     10) modify or clear any account;
  38.     11) display the net-worth (updated with each entered transaction);
  39.     12) maintain several independent account-systems in the same data
  40.       file prohibiting cross transactions, but allowing cross totals;
  41.     13) reconcile checking account and credit card statements;
  42. ...and many other features...
  43.  
  44.     The program is fast and efficient.  You can re-sort a thousand
  45. transactions in about 1.7 seconds; moreover, you can completely reprocess
  46. those same thousand transactions in about 1.6 seconds.  Displayed totals are
  47. updated after each new transaction is processed.  The program itself uses
  48. about 70K plus the space for accounts and transactions.  For 80 permanent
  49. accounts and 1000 transactions, it takes about 155-190K depending upon which
  50. windows are opened.
  51.  
  52.     I recommend that you dump this text file to your printer, because it
  53. will make it easier to take the following quickie tour through the program's
  54. features.  It contains embedded ANSI commands for form feeds and underlines.
  55.  
  56.  
  57.  
  58.                                                       Pass-the-Bucks.doc -- 2
  59.  
  60.                             The Cook's Tour
  61.  
  62.     
  63.     You are Ivan the Terrible, the Czar of all Russia, and so you need to
  64. keep track of just what goes where in your kingdom.  What better helper than
  65. your trusty Amiga!
  66.  
  67. To start the demo:
  68.     from the Workbench, click on the "PTBDemo" Icon. 
  69.     from the CLI, make sure you are in the right directory;
  70.       then type "PTBDemo"
  71.         (NB: these both presume that the font PTBfnt is properly installed
  72.              in the fonts: directory)
  73.  
  74. Several windows will be opened:
  75.     Bottom Window is a brief listing of the accounts, displayed in
  76.       batches of twenty, each with its current balance.
  77.     Top Windows ("Group Totals" and "Wash Accounts") are directly on top
  78.       of each other.  Press F9 (function key 9) to flip back and forth
  79.       between the two.
  80.     Middle Window is labeled "Enter New Transaction".  This is ready to
  81.       receive data.  There are three lines:
  82.  
  83.       1) The bottom line (marked with the "---->") is the data for the
  84.          working (new) transaction
  85.       2) The middle line is the data entry line with the name of the
  86.          current field being edited.
  87.       3) The top line displays the previous transaction.  It is helpful
  88.          for entering similar data into several transactions.
  89.  
  90.     We will return to this Edit Window later.
  91.  
  92.     Try selecting Sort Transactions" from the Project Menu.  Notice that
  93. a small blue window appears briefly telling you that the transactions are
  94. being sorted.  This is called (would you believe?) the Message Window.  It
  95. appears on occasion with its good or bad news.
  96.     Now try selecting "Reprocess" from the Project Menu.  In the brief
  97. time that the message window appeared, Pass-the-Bucks cleared all the
  98. accounts to zero, and reprocessed all the transactions from the beginning of
  99. the file, reset all the end-of-month totals for each account, and redisplayed
  100. the (possibly updated) totals in the windows.  Most of the time is spent
  101. displaying the Message Window and updating the screen.  You'll find that you
  102. can reprocess 1000-1500 transactions in about the same about of time.
  103.     Press F2.  Notice that the next batch of accounts (bottom window) are
  104. displayed.  Pressing F1 displays the previous batch.  When the screen
  105. flashes, it means that there are no more accounts to be displayed in the
  106. direction you are going.
  107.     Explore the menus at the top.  NOTE: the menus are attached to the
  108. Edit Window (the MIDDLE window).  If you find you cannot get the menus, be
  109. sure that you have clicked in the Edit Window to activate it first.  Notice
  110. also that there are Amiga-key shortcuts for a number of common operations. 
  111. They are found right in the menus/submenus.
  112.     In the Transactions Menu under "Select by...", choose "All
  113. transactions" to display a list of all stored transactions.  Exit this
  114. display by clicking on the Close Gadget.  You can get the same display by
  115. pressing F3.
  116.  
  117.  
  118.     
  119.                                                       Pass-the-Bucks.doc -- 3
  120.     
  121.     Try Transactions Menu again.  This time choose, "Select by..."
  122. Acct Number.  Type in a "12" and press <return>.  This generates a ledger-
  123. page listing of all the transactions that affect account #12.  Notice, by the
  124. way, that since this is an income account, it is normally negative.  The
  125. final total (e.g., -$25000.00) tells you that the cumulative amount of salary
  126. received is +$25000.00. This is normal accounting practice.  Think of it as
  127. having transferred $25000.00 from the salary account to the bank account. 
  128. This means the balance of the Bank Account (#2) is up, and you can tell how
  129. much of the balance is accounted for by salary by looking at the negative
  130. number under Account #12.  So in an income account, -$25,000 is a good thing. 
  131. Exit this display by clicking on the Close Gadget or by pressing F10).
  132.  
  133.  
  134. Entering a New Transaction
  135.  
  136.     Now, in the Enter New Transaction window, type in the date "8/25/87".
  137. Notice that the letters enter a date in the blue data-entry area.  Press
  138. <return> and see that the program converts your entry to 25aug87.  Now type
  139. in "2" for the Debit Account, press <return>; type in "19" for the Credit
  140. Account, press <return>.  Notice where each of these entries goes on the
  141. third line of the display, and that the field named in the prompt is
  142. highlighted in blue on the third line.  
  143.     Now type in "Burger King" for the description and press <return>;
  144. type in "4.65" for the amount and press <return>.  View the whole transaction
  145. on the third line, and then press <return> again at the prompt "Data
  146. approved?".  This approves the data and sends it off for processing.  The
  147. totals are updated in the other two windows.
  148.     If you want to exit the demo WITHOUT making any changes to Ivan's
  149. accounts, select "Abort" from the Project Menu (or press RightAmiga-Q).  If
  150. you want to save the changes, select "Normal Exit" (RightAmiga-E).  If you
  151. want to save the current without leaving the program, select "Store Files"
  152. (RightAmiga-F).  
  153.  
  154.     Now, let us proceed in greater detail.
  155.  
  156.  
  157.                      Understanding the Window Displays
  158.  
  159. Previously-Entered Transactions
  160.  
  161.     Press F3 (or choose Begin Display from the Transactions Menu).  This
  162. initiates a display of ALL the transactions.  Pressing F1 (or F2) will go
  163. backward (or forward) amid the transactions, a screenful at a time.  Using
  164. the mouse on the slider gadget (extreme right) will have a similar effect,
  165. but with much larger chunks.  Pressing F10 (or clicking on the standard
  166. Close Gadget) will end the display.  
  167.  
  168.  
  169.  
  170.  
  171.                                                       Pass-the-Bucks.doc -- 4
  172.  
  173.     Each transaction looks something like this:
  174.           (NB: 'xct' means transaction)
  175.  
  176.     xct number    descriptions(20char)      amt
  177.          \              \/                        \
  178.         123> 12may87 doughnuts            0      4.65 f13t16
  179.         142> 15may87 cashed check      1402    200.00 f 1t13
  180.                 \                       /\             /    \
  181.             xct date            reference #     'from' 'to'
  182.                                  (e.g. check #'s) (account numbers)
  183.  
  184.     xct number: This is simply the current number of the transaction.  If
  185. a later transaction were added with a date previous to this, this number
  186. would change.
  187.     xct date: This is the date of the transaction.  The transactions are
  188. sorted first by this field and second the first 10 characters of the
  189. description.
  190.     description: This is any set of ASCII characters.  There is a routine
  191. to search through these description for any string of characters.
  192.     reference #: This is an optional number (e.g., 1402) associated with
  193. the transaction, such as a check number or an invoice number (numerals
  194. only).  This field is not used by Pass-the-Bucks in any calculation or
  195. sorting.
  196.     from/to acct numbers: 'from' = debit, 'to' = credit.  'f13t16' means
  197. that the amount of the xct is subtracted FROM account #13 and added TO
  198. account #16.
  199.  
  200.     The letter gadgets on the right margin (E,P,D,S) stand for Edit,
  201. Print, Delete, and Search.  We'll get to them later.  The "X" gadget cancels
  202. all gadgets.  The arrow gadgets have exactly the same effect as pressing F2
  203. or F1 (forward or backward one screenful).  
  204.  
  205.     Return now to the main window (F10 or Close Gadget).
  206.  
  207.  
  208. Displaying Selected Transactions (Ledger Pages)
  209.  
  210.     Choose "Select from..." from the Transactions Menu, and then sub-
  211. select "Acct Number".  You will be prompted to enter an account number. 
  212. Type in the number 3 and press <return>.  PTB then opens a new window
  213. to display all the transactions which affect Account #3.  The display of
  214. each transaction is much the same as before except that now the amount of
  215. the transaction is displayed either in the left (debit) column or the right
  216. (credit) column, depending on whether the account involved (in this
  217. example, #3) is being debited (subtracted from) or credited (added to).
  218.  
  219.                                            debit  credit  cumulative      
  220.                                             amt    amt     balances
  221.                                              \/    \  /      \/
  222.    123> 12may87 doughnuts            0      4.65    \/     146.78 f 3t16
  223.    142> 15may87 cashed check      1402            200.00   346.78 f 1t 3
  224.                                                                       
  225.     debit/credit amts: This is the amount of the transaction displayed
  226. in the appropriate column.
  227.     cumulative balance: This is the balance amount in the account after
  228. the processing of this transaction.
  229.  
  230.  
  231.  
  232.                                                       Pass-the-Bucks.doc -- 5
  233.  
  234.     Notice, by the way, the letter gadget "M" (for Mark), and the two
  235. arrow gadgets which have the same effect as pressing F2 or F1, namely,
  236. forward one screenful, or backward to the beginning.  NB: This is different
  237. from the F1 of the "All transactions" display.
  238.  
  239.     Return to the main window (CloseGadget or F10).
  240.  
  241.  
  242. The Edit Window for New Transactions
  243.  
  244.     The window labeled "Enter New Transactions" is Grand Central
  245. Station for all the Pass-the-Bucks activities.  So far, we've looked at some
  246. transactions that have been entered previously.  Now let's enter a new one.
  247.  
  248. Entering Dates
  249.  
  250.     On the middle line of the Edit Window, there is a blue strip with the
  251. word "Date:": preceding it in white.  Type in the date November 12,1987, in
  252. the format mm/dd/yy (i.e., 11/12/87) and press <return>.  Notice that the
  253. program translates the date into "12nov87" on the line below (the "current
  254. transaction" line).  Also, the prompt line now says, "Debit Account:", and
  255. the field "f00" is highlighted.  Now press <Shift-LeftArrow>.  The program
  256. has "backed up" to the date field again.  This works for any field.  
  257.     Try entering the date September 1, 1987, as "090187", or "9/1/87" or
  258. "9-1-87", backing up between each try to the Date prompt.  Now try typing
  259. "3" for the date.  Notice that just the day of the month has changed.  Now
  260. try "10/5"(or "1005") to change both the month and day-of-month.  Enter
  261. the letter "t", and notice that the program converts it to today's date
  262. (current system date); likewise "y" converts it to yesterday's date.
  263.     Do NOT use the form 10oct87.  The program will reject it.  This
  264. format "10oct87" was chosen for its compact display.  It also puts the most
  265. variable portion first, and the least variable last.
  266.  
  267.     Summary:
  268.  
  269.     If the date displayed is 05may87 and system date is 10may87, then:
  270.     
  271.     t        changes date to    10may87 (today=system date)
  272.     y        changes date to    09may87 (yesterday)
  273.     3 or 03        changes date to    03may87
  274.     20        changes date to    20may87
  275.     4-1 or 4/1
  276.      or 0401    changes date to    01apr87
  277.     090588 
  278.      or 9/5/88    changes date to    05sep88
  279.  
  280. Entering Account Numbers
  281.  
  282.     Now let's say that Ivan has just purchased two Russian Wolf Hounds to
  283. maul wandering serfs found on the palace grounds.  He paid $250 for them
  284. by check.  So the $250.00 is being subtracted from account #2 (Royal Bank)
  285. and added to an expense account #28 (Serf Hunting).  You can see these
  286. accounts in the bottom window.  Enter "2" for the Debit Account, and "28"
  287. for the Credit Account.
  288.  
  289.  
  290.  
  291.  
  292.                                                       Pass-the-Bucks.doc -- 6
  293.  
  294. Entering Amounts
  295.  
  296.     Enter "250" for the amount.  Notice that "amount" is in dollars, so
  297. that you may enter "250" or "250.0" or "250.00" all with the same result. 
  298. Five cents must be entered as ".05", ten cents as ".1" or ".10".
  299.  
  300. Correcting errors
  301.  
  302.     After you have entered the amount, you are asked to approve the
  303. whole transaction as it stands there on the last line of the Edit Window. 
  304. If all is okay, press return.  If anything is wrong, you may (1) backup to
  305. the problem field by pressing Shift-LeftArrow; or (2) start over by typing
  306. in "n" (or "no", or "no way, Jose", etc.) and then pressing <return>.  You
  307. may accept any field as is, by simple pressing <return>.  
  308.  
  309.     When all is acceptable, press <return>, and the program
  310. (1) processes the transaction immediately, 
  311. (2) posts the updated totals to the top and bottom windows of the screen,
  312. (3) moves this transaction to the top line of the Edit Window as the "last
  313.     transaction", and
  314. (4) clears the data (except the date) from the current transaction in
  315.     preparation for the next one.
  316.    
  317. Displaying Accounts Data
  318.  
  319.     Now, from the Accounts Menu, select "Display Accounts".  Once the
  320. window has displayed its data, explore the menus at the top of the window. 
  321. Notice a new letter gadget "C" (for Continuous Edit); know also that the
  322. "M" gadget in this window stands for "Move".  From the leftmost menu
  323. ("Display") choose "Basic Data" if it is not already selected.  Data from
  324. each of the accounts is displayed on lines like these:
  325.  
  326. acct #    description                budget   current balance
  327.    \            
  328.    12> Royal Salary          4 -1 1   60000   -25000.00
  329.    13> Serf Hunting          7  1 1    4000      824.00
  330.                             /   |  \
  331.                         group type system
  332.  
  333. BUDGET: This amount is STORED as an annual budget.  Depending upon the
  334. setting in the "Period Length" menu, it is DISPLAYED either as an annual,
  335. quarterly, or monthly figure.
  336.  
  337. CURRENT BALANCE: This is stored as the year-to-date figure.  Depending
  338. on the setting in the "Period Length" menu, it is displayed as a year-to-
  339. date, a quarter-to-date, or month-to-date figure.
  340.  
  341. GROUP: This number tells you what special group this account belongs to. 
  342. The sum total of all the accounts having the same group number appears in
  343. the upper window on the original screen.  These groupings are optional and
  344. arbitrary, and are set completely by the user.  Each account may belong to
  345. at most one group.
  346.  
  347. TYPE: This number refers to the one of the standard accounting terms such
  348. as ASSET (3) or LIABILITY (-3) or EXPENSE (1).  These codes may be
  349. displayed by choosing the Help Window from the Display Menu.
  350.  
  351.  
  352.  
  353.  
  354.                                                       Pass-the-Bucks.doc -- 7
  355.  
  356. SYSTEM: This field (default=1) allows you to create several (up to 8)
  357. completely independent accounting systems within the same file.  The
  358. advantage of a separate system is that you can be assured that transactions
  359. cannot accidentally transfer money from one system to another.  Yet the
  360. group totals allow you to add up balances from different systems, e.g., a
  361. common credit card for both business and personal charges, a common bank
  362. account for two people or for one person with two different uses.   
  363.  
  364.     From the Display Menu, select "Comparison Totals", and watch the
  365. changes in the title bar at the top of the window.  In the account lines,
  366. the figures given after the description indicate:
  367.  
  368.     1) the (user-set) budget for this period (year, quarter, month),
  369.     2) the current balance for this period,
  370.     3) the percentage of the period's budget that this balance represents,
  371.     4) the number of percentage points difference between (3) and the percent
  372.         of the time elapsed from the beginning of the period.
  373.     For example, consider an expense account.  If the fiscal year started on
  374. January 1 and the current date is April 1, then about 25% of the year is gone.
  375. If 30% percent of the budget is spent, then the deviation from 25% is +5%;
  376. this means that you are over budget for this time in the year.  
  377.     NB: In the demo version, the "current date" is always 12/28/87.  This
  378. gives meaningful numbers to the percentages.  In the shareware version, the
  379. "current date" is always the system date.
  380.  
  381.     From the Period Length Menu, select "Quarter".  Note that the budget
  382. amounts are 1/4 of what the yearly budgets were.  The balance displayed is
  383. the amount brought into the account since the beginning of the period.  So,
  384. for an expense account, it represents exactly how much was spent since the
  385. beginning of the current quarter.  The percentages and deviation are
  386. likewise calculated with the quarter as the basic unit.  Similarly, the
  387. period length of "Month", displays all as beginning from the current month
  388. (i.e., based on the last end-of-month totals). 
  389.     The BaseMonth Menu allows you to choose months other than the
  390. (default) current one in order to see the balances as of the end-of-month
  391. marker (cf. End-of-Month, below) for the selected month.
  392.  
  393.  
  394.  
  395.  
  396.                                                       Pass-the-Bucks.doc -- 8
  397.  
  398.                          End-of-Month (EOM)
  399.  
  400.     PTB keeps track of the year-to-date balances for each account at the
  401. end of each month for (1) up to eleven previous months, (2) for the current
  402. month, and (3) a total for the "Initial Status" balance at the beginning of
  403. the fiscal year.  This enables quick calculation of quarter figures and
  404. various budgets, etc.  
  405.     In order to maintain this, PTB uses dummy end-of-month transactions. 
  406. They look like this:
  407.  
  408.     150>  99may87  ~~~~~~~eom~~~~~~~     0        0.00   f 0t 0
  409.  
  410. The significant elements are:
  411.  
  412.     1.  the "99" for the day of the month.  This forces the EOM trans-
  413.          actions to come after all the other transactions of the month.  
  414.     2.  the tildes (~) at the start of the description.
  415.     3.  the 0's in the "from" and "to" accounts: viz.,"f 0t 0".
  416.  
  417. When PTB processes one of these EOM transactions, it makes a copy of the
  418. current year-to-date balances for this particular month-end.  The easiest
  419. way to produce one of these EOM transactions is to use the End-of-Month
  420. selection from the Project Menu.  This procedure (1) creates an EOM
  421. transaction for the current/recent month, (2) sorts the transactions, (3)
  422. reprocesses all the transactions again.  
  423.     Explore the BaseMonth Menu attached to the original Edit Window. 
  424. Notice that eleven months of the (user-defined) fiscal year are present and
  425. also an EOY (end-of-year). [NB: to specify the fiscal year beginning, use
  426. the program AcctSetup].  "EOY" refers to the status of the accounts at the
  427. end of the previous fiscal year.
  428.     Several displays can take as their starting point the currently
  429. selected BaseMonth instead of the current status.  For example, if you
  430. explore the Accounts Menu, you will notice that the selection "As of..."
  431. has as one of its options "BaseMonth".  This will display the accounts as of
  432. the end-of-month of the selected month.  If you explore the Transactions
  433. Menu, you will see that the selection "Starting from..." has the option
  434. "BaseMonth".  This means that the display of selected transactions (ie.,
  435. selected by account number, group number, etc) will begin with the EOM
  436. transaction of the selected BaseMonth.
  437.     Note that PTB gets its notion of what the current month is from the
  438. number of EOM transactions in the list rather than from the dates of the
  439. transactions.
  440.  
  441. This concludes the tour of the program's basic features.
  442.  
  443.  
  444.  
  445.  
  446.                                                       Pass-the-Bucks.doc -- 9
  447.  
  448.                             ShareWare
  449.  
  450.     This version (3.0.0) is the first one released to the public.  It is
  451. released nominally as shareware for small donations ($5 to $15) depending upon
  452. how useful the program is to you.  The main reason for the shareware label is
  453. to get some feedback from people, and possibly new ideas.
  454.  
  455.     For a shareware contribution you will receive:
  456.  
  457. 1.  The full documentation (including how to set up your own account
  458. system and many features not presented here)
  459.  
  460. 2.  The PTBsetup program which allows you to change the key parameters
  461. of the system such as the number of permanent accounts and the number of
  462. transactions which you may enter during one session.
  463.  
  464. 3.  The latest version of the program.
  465.  
  466. 4.  The satisfaction of knowing you helped out fellow Amiga users.
  467.  
  468. 5.  God's blessing.  (Priests always say things like that.)
  469.  
  470.  
  471. Send shareware contributions to
  472.  
  473.     Amiga Users of the Heartland, Inc.
  474.     P.O. Box 1432 DTS
  475.     Omaha, NE  68101
  476.  
  477.     (Think of it as a collection after a Sunday sermon.)
  478.  
  479. Send suggestions and questions to
  480.  
  481.     Rev. Robert J. Dufford, S.J.
  482.     Creighton University
  483.     2500 California St
  484.     Omaha, NE  68178
  485.  
  486.     BBS:
  487.         Bob Dufford
  488.         The WindDragon Inn:  402-291-8053
  489.  
  490.  
  491.     Many thanks to Jim Geeding, treasurer of our User Group, for the
  492. title "Pass-the-Bucks"; and to Larry Zwart and Dale Hermsen for helpful
  493. feedback on the program.
  494.  
  495.         HAPPY ACCOUNTING !!!
  496.